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Objectives 


ifikocts 


Describe  PL/ SQL  Collections 
Types  of  collections  in  PL/ SQL 
Index  By  Table  mj!  ^wS^^*" 

BULK  COLLECT,  FOR  ALL  Clauses 

Performance  gains  with  Bulk  Processing 

Array  processing  with  BULK  COLLECT 
and  FORALLf —  '-  ^ 
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Collections  in  PL/SQL 


In  PL/ SQL  a  collection  variable  is  a 
variable  that  can  store  zero,  one  ore 
more  elements  of  a  specific  type  (either 
an  internal  data  type  or  a  user  defined 
data  types).  The  type  of  the  variable  is^ 
itself  a  user  defined  type.  Since  a 
collection  is  a  user  defined  type,  a 
collection  type  can  store  collections  as 
well.l  / 
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Different  collection  types 


There  are  three  collection  types  in  PL/ SQL: 

•  Nested  tables  ^^^^^T^^""^^^^?^^^^ 
Index-by  tables,  also  known  as  associative 

•  Varrays 


\ 


9  Nested  tables  extend  the  functionality  of  index- 
by  tables.  The  main  difference  is  that  nested 
tables  can  be  stored  in  a  table  column  while 
index  by  tables  can  not.  ^ 
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Example  :  Index  by  tables 

declare  type 

assoc_varchar  is  table  of  varchar2(10)  index  by  pls_integer; 
var_assoc_varchar  assoc_varchar; 
elem  varchar2(10); 
begin 

var_assoc_varchar(40)  :=  'forty'; 
var_assoc_varchar(10)  :=  'ten'; 
var_assoc_varchar(30)  :=  'thirty'; 
var_assoc_varchar(20)  :=  'twenty'; 
elem  :=  var_assoc_varchar.first; 
while  elem  is  not  null 
loop 

dbms_output.put_line(elem  |  |  ':  '  |  |  var_assoc_varchar(elem)); 
elem  :=  var_assoc_varchar.next(elem); 

end  loop; 

end; 
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Example  :  Nested  tables 


declare 

type  table_varchar  is  table  of  varchar2(10); 
var_table_varchar  table_varchar; 

begin 

var_table_varchar  :=  table_varchar  ('one',  ftwof, 
three  ,  four  ); 

for  elem  in  1     var_table_varchar. count 
loop 

dbms_output.put_line(elem  |  |     '  |  | 
var_table_varchar(elem)); 
end  loop; 
end; 
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declare 

type  varray_varchar  is  varying  array(20)  of 
varchar2(10);  var_varray_varchar  varray_varchar; 

begin 

var_varray_varchar  :=  varray_varchar  ('one',  ftwof, 
three  ,  four  ); 

for  elem  in  1     var_varray_varchar. count 
loop 

dbms_output.put_line(elem  |  |     '  |  | 
var_varray_varchar(elem)); 

end  loop; 

end; 
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Bulk  Processing 


•  Supercharge  your  PL/ SQL  code  with  BULK 


COLLECT  and  FORALL 


Working  at  a  table-level  instead  of  the  row- 
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PL/SQL  Code 
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Consists  of  two  types  of  statements 

-  Procedural  (declare,  begin,  if,  while,  for  ...) 

SQL  (select,  insert,  update,  delete)  ^^^^^^^ 
Oracle  has  two  engines  to  process  that  information 

-  PL/  SQL  Engine  ^ 

A  Content  Switch  occurs  each  time  the  PL/  SQL 
engine  needs  to  execute  a  SQL  statement 

Switches  are  fast  but  large  loops  can  cause 
performance  delays        -f^~^_  \  r^^\ 
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Context  Switches 
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Session 


PL/SQL 
Block 

PL/SQL 
Block 


Oracle  Server 


PL/SQL 
Block 

PL/SQL  Engine 

Procedural  Statement 
Executor 

SQL 


Data 


SQL  Statement 
Executor 


SQL  Engine 
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Bulk  collection  Categories 


SELECT  or  FETCH  statements 
BULK  COLLECT  INTO  L=A 


Mr 

Out-Bind  binding  A7m 
RETURNING  clause 


In-Bind  binding 


FORALL  -  INSERT,  UPDATE,  DELETE 
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SELECT  /  FETCH  statements 


Data  may  be  Bulk  Collected/Fetched  into 
Table.column%TYPE  ^SS^S^ 
^  Record  of  arrays a  y  ^ 

Table%ROWTYffikQCtS^^fc^ 
Cursor%ROWTYPE  |^fi^<^^ 

Array  of  records  /^^^^ 
Nested  tables  — / 

4 


Copyright  ©  CD^C-^CrS 


Advanced  Computing  Training  School  (ACTS) 
Advanced  Computing  for  Human  Advancement 


Products  Table 


Create  Table: 


create  table  products  ( 

productjd  number, 
product_name  varchar2(15), 
effective_date  date  ); 


Insert  1,00,000  records: 


A     z-  \    k     \  1   ><  


begin 

--  inserting  100000  records  into  the  products  table 
fori  in  1 ..  100000 
loop 

insert  into  products  values  (i,  VROD'\\to_char(i),sysdate-1); 
end  loop; 
commit; 
end; 
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Bulk  Collect  Clause 
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•  Used  in  a  SELECT  statement 

•  Binds  the  result  set  of  the  query  to  a  collection 

•  Much  less  communication  between  the  PL/SQL  and 


^SQL  engines  \  a"A,  f^f  rC  t  ~-^>^~^-^ 
*  All  variables  in  the  INTO  clause  must  be  a  collection 
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Example  :  Bulk  Collect 

DECLARE 

TYPE  prod_tab  IS  TABLE  OF  products %ROWTYPE ; 
products_tab  prod_tab  :=  prod_tab()  ; 

start_time  number; 
end_time  number ; 

BEGIN 

start_time  :=  DBMS_UTILITY .  get_time  ; 
FOR  prod_rec  in   (SELECT  *  FROM  products 

WHERE  effective_date  BETWEEN  sysdate  -  2  AND  TRUNC (sysdate) ) 
LOOP 

products_tab . extend ; 

products_tab (products_tab . last)    : =  prod_rec ; 
END  LOOP; 

end_time  :=  DBMS_UTILITY .  get_time  ; 

DBMS_OUTPUT . PUT_LINE ( ' Conventional   (Ml products_tab . count  IT): 
'  |  |  to_char  (end_time-start_time)  )  ; 

Start_time  :=  DBMS_UTILITY . get_time ; 
SELECT  * 

BULK  COLLECT  INTO  products_tab 
FROM  products 

WHERE  effective_date  BETWEEN  sysdate  -  2  AND  TRUNC (sysdate) ; 
end_time  :=  DBMS_UTILITY . get_time ; 

DBMS_OUTPUT . PUT_LINE ( 'Bulk  Collect   (Ml products_tab . count  IT): 
'  |  |  to_char  (end_time-start_time)  )  ; 

END; 


Advanced  Computing  Training  School  (ACTS) 
Advanced  Computing  for  Human  Advancement 


Example  :  Bulk  Collect  Explicit  Cursor  Fetch 


start_time  :=  DBMS_UTILITY . get_time ; 

OPEN  products_data ; 

LOOP 

products_tab . extend ; 

FETCH  products_data  INTO  products_tab (products_tab . last) ; 
IF  product s_data%NOTFOUND  THEN 


END  IF; 
END  LOOP; 

CLOSE  products_data ; 

end_time  :=  DBMS_UTILITY . get_time ; 

DBMS_OUTPUT . PUT_LINE ( ^Conventional   (Ml products_tab . count  IT):    'II to_char (end_time- 
start_time) )  ; 

Start_time  :=  DBMS_UTILITY . get_time ; 

OPEN  products_data ; 

FETCH  products_data  BULK  COLLECT  INTO  products_tab ; 

CLOSE  products_data ; 

end_time  :=  DBMS_UTILITY . get_time ; 

DBMS_OUTPUT . PUT_LINE ( ^Bulk  Collect  (Ml products_tab . count  IT):    Ml to_char (end_time- 
start  time) ) ; 


DECLARE 


TYPE  prod_tab  IS  TABLE  OF  products%ROWTYPE ; 
products_tab  prod_tab  : =  prod_tab ( ) ; 

start_time  number; 
end_time  number ; 

CURSOR  products_data  IS  SELECT  *  FROM  products; 


BEGIN 


products_tab . delete (products_tab . last) ; 
EXIT  ; 


END; 
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Bulk  Collect  -  FOR  ALL 


We  have  seen  BULK  COLLECT  with  the 
SELECT  statements  ...  X" 


For  the  INSERT,  UPDATE  and  DELETE 
statements  there  is  the  FORALL  statement 


•  This  is  referred  to  as  IN-BINDING 
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Example  :  Bulk  Collect  - 

FOR  ALL 

DECLARE 

TYPE  prod_tab  IS  TABLE  OF  products%ROWTYPE; 
products  tab      prod  tab  :=  prod  tab(); 
start  time    number;     end  time  number; 
BEGIN 

—  Populate  a  collection  -  100000  rows 

SELECT  *  BULK  COLLECT  INTO  products_tab  FROM  products; 

EXECUTE  IMMEDIATE   ' TRUNCATE  TABLE  products ' ; 
Start_time  :=  DBMS_UTILITY .  get_time ; 

FOR  i  in  products  tab. first  ..  products  tab. last  LOOP 
INSERT  INTO  products 

VALUES  product s_tab(i)  ; 
END  LOOP; 

end_time  :=  DBMS_UTILITY .  get_time; 

DBMS  OUTPUT. PUT  LINE (* Conventional  Insert:    " |  | to  char (end  time-start  time)); 

EXECUTE  IMMEDIATE   ' TRUNCATE  TABLE  products ' ; 

Start_time  :=  DBMSJJTILITY .  get_time ; 

FORALL  i  in  products  tab. first  ..  products  tab. last 

INSERT  INTO  products  VALUES  products_tab (i) ; 
ena  time  :—  dbmo  ui  iiiii  x .  get.  time; 

DBMS_OUTPUT.  PUT_LINE  (  'Bulk  Insert :    '  \  \  to_char  (end_time-start_time)  )  ; 

COMMIT; 

END; 
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Bulk  Collect  -  Fine  Points 


Use  bulk  bind  techniques  for  recurring  SQL 
statements  in  a  PL/ SQL  loop. 

Bulk  bind  rules:  ^^^^^^^^^I^^^^^^^^. 

Can  be  used  with  any  type  of  collection 
Collections  should  be  densely  filled 
If  error,  statement  is  rolled  back. 

-  Prior  successful  DML  statements  are  not  rolled 
back,  /  tf>> 

Bulk  Collects^/ — ^jll^ 

-  Can  be  used  with  implicit  or  explicit  cursors 

-  Collection  is  always  filled  sequentially  starting 


with  1 
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Summary 
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In  this  session  you  should  have  learned  the 
ffjjjo^mt^^ 

•  PL/SQL  Collection  Types  Tj%*^r^^^^^ 

•  Working  with:i<mQCCS  " 'J  '  V  _ 

•  Index  By  Table  f 

•  Nested  Table 
• VARRAY 

Improving  code  performance  with: 

•  BULK  COLLECT 

•  FOR  ALL  Clauses 
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Thank  You  ! 
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